手把手教你使用 Quarto 构建文档 (1)

点击下方公众号，回复资料分享，收获惊喜

本推文是 “手把手教你使用 Quarto 构建文档” 教程的第一部分，本文先介绍

1. Quarto 构建文档的原理；
2. 可创建的文档类型；
3. 对应的参考资源分享。

下一部分，会手把手介绍如何使用它（下次该系列推文见吧～）。

简介

Quarto^[1] 是一个建立在 Pandoc 上的开源科技出版系统。

• 可以基于 Python、R、Julia 和 Observable 创建动态内容。

• 以纯文本 markdown 或 Jupyter 笔记本的形式编写文档。

• 以 HTML、PDF、MS Word、ePub 等格式发布高质量的文章、报告、简报、网站、博客和书籍。

• 用科学的 markdown 进行创作，包括方程、引文、交叉引用、图板、呼号、高级布局等等。

基于四种不同语言构建的文档，案例如下（左边为源码，右边为输出结果）：

基于 Python 创建文档

基于 R 创建文档

基于 Julia 创建文档

基于 Observable 创建文档

类型与 R Markdwon 比较类似。第一部分是 YAML，后面是正文内容（包含：文字，代码等）。

小编认为如果你会了 R Markdown 制作各类文档，你再来看这些内容，难度应该都不大。两者其实非常相似。如果你有这样的担心：是否需要转战 Quarto 构建文档？，或许你可以看看谢益辉写的博客^[2]。

它是如何工作的？

在渲染 Quarto 文档时，首先执行所有代码块，并创建一个新的 markdown (.md) 文档，内部包括代码及其输出。然后由 pandoc 处理创建最终的格式（PDF、Word 等）。而这整个步骤都封装到了 Render 按钮中，读者只需要点击 Render 按钮即可编译得到对应的输出文档（各类文档，下一节讲给出）。

工作流程

RStudio 中的 Render 按钮

可创建的文档类型

官网给出了很多很创建的文档类型，并开源了对应的代码。读者可以尝试下载，并读懂，并将其为己所用。这里小编将其简单罗列了下：

文章和报告

具体模板可见：https://quarto.org/docs/gallery/#articles-reports

文章和报告

幻灯片

具体模板可见：https://quarto.org/docs/gallery/#presentations

幻灯片

交互式文档

具体模板可见：https://quarto.org/docs/gallery/#interactive-docs

交互式文档

网站

具体模板可见：https://quarto.org/docs/gallery/#websites

网站

书籍

具体模板可见：https://quarto.org/docs/gallery/#books

书籍

资源分享

本文主要分享基于 R 语言创建 Quarto 文档。

1. 官网的基于 R 语言的 Quarto 文档教程^[3]

1. RStudio 举办的 R 会议等给出了一些视频教程。小编将一些最新的教程搬运到了 B 站，供大家学习：

1. 其他相关的博客1^[4]，2^[5] 等。

小编有话说

小编有打算制作一个简短的教程（或者是免费的直播），简单介绍下 Quarto 的使用方式。现在这挖个坑，准备好了再通知大家。

参考资料

[1]

Quarto: https://quarto.org/

[2]

博客: https://yihui.org/en/2022/04/quarto-r-markdown/

[3]

基于 R 语言的 Quarto 文档教程: https://quarto.org/docs/get-started/hello/rstudio.html

[4]

1: https://www.rstudio.com/blog/announcing-quarto-a-new-scientific-and-technical-publishing-system/

[5]

2: https://medium.com/appsilon-data-science/r-quarto-tutorial-how-to-create-interactive-markdown-documents-9e6c35983fe6